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ABSTRACT 

I 



This thesis is a summary of the design and implementa- 
tion of a user interface for a color, raster-scan graphics 
display device. The problems, solutions and a general set 
of guidelines related to desianina an interface for a color 
capable graphics device are discussed. The implementation 
of a software interface for a RA^TEK G X - 1 0 0 A with the 
PDP-tl/50 computer is presented. The interface is imple- 
mented within the conventions of the C programming language 
and executes under the UNIX operating system. Recommenda- 
tions for further expansion of the interface are di scusseo. 
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I 



INTRODUCTION 



This thesis is the design and implementation of a user 
interface for a color, raster-scan display device, specifi- 
cally the RAMTEK GX-100A. The basic design and operation of 
the device as imolemented in the Naval Postgraduate School 
Computer Laboratory is discussed. 

The actual design and operation of the interface is 
presented as well as the orobl ems which were considered in 
its design and construction. The main consideration in the 
design of the interface was how to effectively imolement the 
use of color in a graphic disolay. 

The concept of a color triole and color cube are intro- 
duced as natural extensions of the method used by color 
graphics devices. However, the triple and cube are strictly 
defined by limitations in the hardware that restrict the 
number of colors that can be generated to 4096. 

A user's manual was written to enable the user to util- 
ize the interface from a program written in the high level 
language, C 111, supported by the UNIX operating system on 
the PDP-11/50. It is included in Appendix A. 
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II. general description of raster scan devices 



The cathode ray tube is the most widely used graphics 
display device today. It consists basically of an electron 
gun which projects a beam of electrons onto a screen which 
has a phosohor coating. The phosphor is excited when struck 
by the beam of electrons and emits visible light which is 
perceived by the viewer. Due to the short persistence of 
the phosphor utilized on most cathode ray tubes, it is 
necessary to reoeatedly excite it to minimize fading of the 
image and reduce visible flicker. There are two basic 
methods used to refresh a display. The first is to directly 
trace the image beina produced several times a second with 
the electron beam turned on. The second is to scan the 
entire screen with the beam, while only turning the beam on 
and off when desired to produce the image. The second is 
known as the raster scan technique. It is the same teen- 
nique used in commercial television sets. 

In raster scan devices, the screen is divided into lines 
and elements. Lines extend horizontally across the screen 
and elements are discrete positions on a line. A specific 
element on a specific line is called a pixel. Figure 1 
illustrates the relationship of lines, pixels and elements 
to each other and the screen. The number of pixels deter- 
mines the resolution of the screen. The more pixels, the 
higher the resolution of the picture* 
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ELEMENTS 




Line/ Element/ Pixel Relationship 
Figure 1 



The added feature of color in a raster scan device re- 
quires the addition of two more electron guns and a more 
complicated phosphor coating on the screen. The phosphors/ 
representing the primary colors of blue/ green and red are 
located in each pixel area and are called a triad. The 
three guns are used to produce three electron beams to scan 
the screen. These beams are independently varied in intensi- 
ty to excite any one/ two or three phosphors to produce the 
desired color. 

In order for an image to be drawn in color/ not only 
must the electron guns be turned on and off at the orooer 
locations/ out the combination of beams and the intensity of 



each must be adjusted to oroduce the color 



III. THE RAMTEK GX-100A GRAPHICS DISPLAY 

The RAMTEK is an interactive/ raster-scan/ color graph- 
ics display device. It consists of a bi-directional inter- 
face/ a display generator/ solid state memory/ a video look- 
up table/ device multiplexor/ keyboard/ cursor generator/ 
video generator/ and a cathode ray tube 123 . Figure 2 il- 
lustrates the relationship of the hardware and the component 
parts' relationships with each other. 

A. BI-DIRECTIONAL INTERFACE 

The bi-directional interface connects the PDP-11 with 
the video lookup table/ display generator and the device 
multiplexor. The interface establishes data paths to and 
from the CPU and the device multiplexor/ the video lookuo 
table/ and the display generator. 

B. DEVICE MULTIPLEXOR 

The device multiolexor interconnects with the cursor 
generator and the keyboard. It enables the CPU to receive 
data via the RAMTEK keyboard. 

The keyboard converts the keystrokes into extended ASCII 
character codes which are transmitted to the device multi- 
plexor. 

/ 
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RAMTEK Hardware Configuration 
Figure 2 
1 3 



C, DISPLAY GENERATOR 



The display generator contains the standard ASCII char- 
acter codes and hardware logic such that dot-matrix charac- 
ter patterns are generated and passed to the memory. It 
also takes input data and processes it according to the 
instructions" receiveo and writes the aporoor i ate data into 
the memory so the proper image will be displayed. 

D. MEMORY 

The organization of the solid state refresh memory is 
the kev to the operation of the R A M T E K . The memory consists 
of up to eight memory boards (planes) which have the capaci- 
ty to store 512 lines by 640 elements. The R A M T E K used in 
this work has four memory olanes and an effective address 
space of 240 lines by 640 elements. 

As illustrated by figure 3/ the memory can be viewed as 
a three dimensional structure with the x-axis corresponding 
to the elements, the y-axis corresoondi na to the lines and 
the z-axis corresponding to the display subchannels. 

The displav subchannels represent a binary pointer into 
the video lookup table by only oermitting certain planes of 
memory to be written in. Thus the binary code on a certain 
z-axis represents the pointer into the video lookup table. 
This establishes the color to be displayed at that location 
on the screen. For example, if the z-axis at line five, 
element 56 contains a 0101, the pointer into the video look- 
up table points to entry five. 
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Memory Configuration 

Figure 3 

E , VIDEO GENERATOR 

The video generator reads the information stored in the 
refresh memory and generates the comoatable signals for the 
cathode ray tube (CRT) to disolay the image on the screen, 

F. VIDEO LOOKUP TABLE 

The video 1 ookuo table is the center of the color gen- 
erating caoability of the R A M T E K , It contains sixteen arbi- 
trary colors from address zero to fifteen in the table. As 
described aoovej the combination of memory olanes enabled 
by the selected subchannels reoresents the pointer to an 
entry in the video lookuo table. Each entry in the video 
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lookup table consists of a twelve-bit code broken into three 
four-bit binary fractions which corresoond to intensities 
of blue/ green and red. As illustrated in figure 4 / bits 
zero through three represent red/ four through seven 
represent green and eight through eleven represent blue. 
Therefore/ any of ^096 colors can be represented in the 
twelve bits. Only sixteen colors can be diSDlayed on the 
screen at any one time because having four planes of memory 
to represent the oointer to the video lookup table limits 
the pointer value to zero through fifteen. 




Video Lookup Table 
Fiaure 4 
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IV . positional addressing 



There are three methods of address i n a the RAMTEK screen; 
absolute^ indexed and relative. As stated earlier, address- 
ing a raster scan device is accomplished by specifinq the 
line and element number which indicate the address of a 
pixel on the screen. 

Because of the low line resolution of the device used, 
only even lines are aadressabl e. Therefore the line ad- 
dressing is from zero to 480 where zero and one address the 
same line, two and three address the same line and so on. 
The address that is currently being referred to is known as 
the current operating ooint (COP). It is like a oointer to 
a location on the screen where the next entity will be 
d i s p 1 a y e d . 

A . ABSOLUTE ADDRESSING 

By specifying a line and element number, a single pixel 
is addressed in the same way as a point is addressed in a 
cartesian coordinate system. The COP is at that pixel. 

B. INDEXED ADDRESSING 

The RAMTEK provides two index regi ste r s which can be 
used in addressing the RAMTEK screen. To address a location 
usinq index registers, the specified line and element 
numbers are summed with the contents of the line and element 
index registers to yield the address of a oixel on the 
screen. For example, if the specified address is line 100, 
element POO and the line and element index registers contain 
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26 and 30 resoect i vel y# tHe resulting address (COP) is line 
126/ el emen t 130. 

C. RELATIVE ADDRESSING 

This method takes the specified line and element numbers 
and considers them to be displacements# that is# the number 
of lines and elements to add to the COP address to yield a 
new COP. For example# if the specified displacements are 20 
lines and 30 elements# and the COP is line 100# element M0; 
the new COP is line 120# element 170. 

V. CONTROL MODES 

The RAMTEK operates in any one of eight control modes 
(2). Each control moae can be modified by selected control 
flags* The modes and their applicable control flags are 
summarized in Tables I and II. M ore detailed descriptions 
of the modes and how they work are located in Appendix A. 
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TABLE I 



CONTROL MODE DEFINITIONS 



Mode 



Functional Description 



Alphanumeric Data Writes alphanumeric characters 

on the sc reen * 

Transverse Data Decodes the data as a single bit 

oer pixel ana writes the data in 
an eight pixel wide vertical 
column from too to bottom. 



Raster 


Data 


Same as Transverse data but 
writes left to right on the same 
line. 


C omo 1 e x 


Data 


Decodes the data as four 
bits oer pixel and writes left 
to right on the same line. 


Grach i c 


Vector 


Draws continuous lines between 

arbitrary end points. 


Graph i c 


Plot 


Draws a histogram style plot by 
drawing continuous lines between 
successive y-axis points while 
incrementing the x-axis from 
left to riaht. 


Graph i c 


Cartesian 


Draws solid rectangles be- 

tween arbitrary end ooints. 


Graphic 


Element 


Draws a dot at specified point. 
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TABLE II 



CONTROL FLAG DEFINITIONS 



Name 



Functional Description 



Index Address i ng 
Reverse Background 
Additive Write 
Doub 1 e Width 

Fixed Point 



Causes indexed addressing to be 
in effect. 

Causes ones written in memory to 
become zeros and vice-versa. 

Causes the new image to written 
H on top" of the existing image. 

Doubles the width of generated 
data by writing each bit of data 
into two elements instead of 
one . 

Uses the ooint defined by the 
contents of the line and element 
index registers as the starting 
point for each graphic entity. 



VI. SPECIAL FUNCTIONS 

There are two special functions which alter the display. 
The first is the erase instruction and the second is the 
scroll function. 

The erase function simply writes all zeros or ones into 
memory depending on the state of the background flag in the 
control mode and the subchannels selected. 

The scroll function creates a moving window effect by 
moving the image vertically for a specified number of lines. 
A positive or negative number i n o i cates which direction the 
image will move. Images that are scrolled off the top of 
the screen re-enter the bottom and vice-versa. 
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VII 



GENERAL USER INTERFACE DESIGN 



One of the governing constraints in developing software 
for graphics output is the fact that it is harder to 
describe a picture than it is to describe a table of words 
or numbers. 

For this reason# some of the normal principles of good 
system design apol y with exceptional force* The user who 
has the job of describing a picture must be provided with a 
set of instructions and graphic tools that enable him to 
concentrate on the image he wishes to create* The user must 
not be distracted by irritating details imposed by the 
peculiarities of the hardware. He must be allowed to ex- 
press alqorithims as he conceives them# and be able to trace 
and correct errors with a minimum of trouble. It is essen- 
tial that the graphics system be simple to oroaram (31. 

An excellent general approach to designing a user inter- 
face for graphics systems is expressed by Wagner and LaHood 
[33. It describes some general guidelines in which a level 
structure is built. 

A * MULTILEVEL STRUCTURE 

A multilevel design is based on buildina blocks which# 
at the lower levels# involve efforts to provide an efficient 
interface between the computer and the graphic device. 
Higher levels of software are then developed to increase the 
productivity of the total system. Routines on the lower 
levels are dependent on hardware# but as levels increase# 
the dependence on hardware decreases# and the complexity of 
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t he f unc t ions 



performed by software increases 



At the 



highest level the routines are totally independent of 
hardware. 

1* Level I - Primitive Hardware Oriented Subroutines 

Level I routines are intimately concerned with the 
hardware characteristics of the device. These form the 
basis for building Level II routines. Examples are primitive 
display command utilities# display instruction assembler# 
interrupt handling routines# and device controllers. 

2. Level II - Complex Information Handling Subroutines 
Level II routines combine the facilities of the 

operating system with the hardware oriented routines of Lev- 
el I to provide the programs and user oriented languages 
to Pe used at Level III. Examples are file management# 
buffer management utilities# and utilities that convert user 
defined coordinate systems to a device dependent coordinate 
sy s t em. 

3. Level III - Generalized User Oriented Subroutines 
Level III routines have the ability to perform 

several Level II routines to accomplish a single task. The 
routines allow spec i f i cat i on of disolav functions through 
device independent parameters. They are called within a 
procedural 1 anguaae like C [11# Algol or Fortran. There- 
fore# they add to the capabilities of an existing implemen- 
tation. Examples are plot routines# automatic scaling# 
print and label routines. 

4. Level IV - Aoplication Lanquaae Processors 

Level IV proaramming support is directed at the user 
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who is not a Programmer. It is intended to make him less 
dependent on programming by simplifying the task of specify- 
ing graphic output* Once implemented by using routines in 
Levels 1/ II and III , and other programming techniques^ user 
languages provide access to the graphic device and increase 
its usefulness. Examples of some Level IV user-oriented, 
high level language systems are MIT Sketch Pad [4], Bell 
Animation Language [5,6] and GM Design Analysis System [7]. 

VIII. USER INTERFACE DESIGN FOR THE RAMTEK GX-100A 
A. GENERAL 

In the design of a user interface for a color graphics 
device a primary consideration is to make the use of color 
as easy for the user as Possible. The user should be per- 
mitted to make up colors at the device and be given a simple 
method of selecting the colors desired in the application 
program. The user should be allowed to modify the colors at 
will either during proaram execution or by a pre-execution 
selection process. The user should be relieved of select- 
ing the exact bit patterns needed to produce the color on 
the screen. Elimination of device dependent programming 
allows the user to think of color as it applies to a orob- 
1 em . 

It is necessary to isolate the user from the low-level 
assembly languages to allow concentration on the problem and 
not have to worry about when and how to issue the proper 
hardware instructions to the display device. A user should 
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be able to think in terms of a virtual screen space of his 



own definition and not be concerned with hardware address- 
i ng • 

When a user interface is designed/ it should be easily 
integrable with the host computer language. The easiest way 
to accomplish this is to use subroutine calls from the user 
program. The calls should be keot as simple to use as prac- 
ticable. Toward this end/ the number of parameters involved 
should be keot to a minimum. 

The user should be protected from abnormal termination 
as much as possible by the interface. As an example/ the 
interfacing routines can check the Dassed parameters to 
ensure that they are correct. They should indicate errors 
and what they are to simplify debugging. Graphic tools 
provided to the user should encourage concise/ clear 1 pro- 
grams i ng . 

The overall or incioles and methods of level design as 
discussed earlier were followed in implementing the inter- 
face for the RAMTEK. Since Level I routines were essential- 
ly complete or were hardware implemented/ the resulting 
design took place more in the Level II and Level III areas. 
It was decided to implement the interface as a set of 
subroutine calls from the C [1] programming language because 
C is the primary language on the host computer and because 
of its simple subroutine calling format. 

As a first step/ a set of primitives were designee to 
form the basis for other routines to build on. 
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1. Primitive Functions 

The primitive functions make up the majority of the 
level II and level III routines. The criteria followed in 
choosing the orimitive functions were clarity* convenience* 
and compactness. Clarity means primitives are to perform 
only one function and that function must be clear and sim- 
ple. 

Due to the hardware caoabi 1 i tes of the RAMTEK, 
several primitives became user routines on Level III as well 
as being primitives. The construction of a set of primi- 
tives condensed the entire capability of tne RAMTEK hardware 
functions to 21 instructions or subroutines. The primitives 
which are applicable to user programs are described in 
Append i x B . 

B. APPLICATION OF COLOR 

After the design of the primitive set* it was necessary 
to design a method by which the user would be able to easily 
utilize and understand how to get color into a display and 
control or modify it. Two Key concepts were used. The 
first was extended from an actual hardware feature. It was 
the video lookup table concept translated into a color 
table. The available colors can be thought of as a book of 
colors from which the user can choose the Page he wishes to 
use. The page corresponds to the color table. Ml the user 
needs to do is select the page (color table) and color 
(entry) desired and then draw the entities using that color. 
The concept works well* but a problem arose as to how to 
present the information to the user so it is understandable 
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and useaole 



Humans have the characteristic of not all per- 



ceiving the same color the same way, A shade of blue to one 
person, may not be the same to another. And of course, some 
humans have varying degrees of color-blindness. Also, 
reproduction of color in manuals and photographs may not be 
accurate representations of the color the RAMTEK displays on 
its CRT. As a result of these considerations, it was decid- 
ed t ha t an interactive orogram should be designed and i m - 
plementated into a subroutine call to allow the user to 
examine and work with the colors while actually viewina them 
on the RAMTEK screen, 

1. Interactive Program 

The interactive subroutine's purpose is to allow the 

user to see and modify color tables while seated at the 

RAMTEK keyboard. It embodies several features. 

* 

a. Self-tutorial 

As the user utilizes the routine, instructions 
are given at each step as to how to orogress through the 
various eaiting modes. 

b. Color Table Display 

The oage representing a soecific color table is 
designed so the user sees the fifteen colors in three modes; 
a solid block of color, a line of color and alphanumeric 
characters of the color are displayed. The display thereby 
shows the different appearance color can take on when 
displayed in different shapes. 

c. Multiple Edit Modes 

The routine provides five methoas of editing and 
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modifying color tables and their entries. This gives max- 
imum flexibility to the novice as well as the more advanced 
user. The use of the interactive routine is explained in 
detail in Appendix A. 

2 . Color Cube 

The color cube transforms the video lookup table 
into a third dimension to further aid in communicating to 
the user how to construct colors and* how they relate to each 
other. The concept of the color cube, as illustrated in 
figure 5/ describes the 4096 colors that can be created by 
defining the colors as ordered triples as follows: (0,0,0) 
to (0,0,15) represent shades of red, (0,0,0) to (0,15,0) 
represent shades of green and (0,0,0) to (15,0,0) represent 
shades of blue. By a careful inverting and combining of the 
three axis, many of the 4096 colors can be created. 

C. VIRTUAL DISPLAY SCREEN 

One of the important considerations of a successful user 
interface was met by writing a routine to allow the user to 
define the address space of the screen. The user defines 
the virtual screen bv givinq floating point cartesian coor- 
dinates representing the lower left and upper right corners 
of the screen. The interface remembers his declaration and, 
until the user changes the virtual screen, all addresses are 
transformed from the virtual coordinates given into real 
screen coordinates. The process is completely transparent 
to the user. To further aid the viewer, an axis system, 
centered where desired, can be displayed on the screen. 

If the user chooses not to declare a virtual screen, the 
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Color Cube 
Figure 5 
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interface defaults to an 100 by 100 unit screen. This iso- 
lates the user from real screen addressing problems. 

All virtual screen displacements are also scaled into 
real screen d i so 1 ac emen t s , thereby giving the user total 
freedom to define the virtual screen as long as a standard 

cartesian coordinate system is used* 

/ 

D. HIGH LEVEL GRAPHIC TOOLS 

A set of level III graphic tools was also designed/ and 
its use and description is detailed in Appendix A. Here 
simplicity/ usablity and unde r s t andab 1 i t y were the driving 
factors in the design* When oossibl e/ the user never has to 
pass more than four parameters. The higher level tools are 
logical operations that require the programmer to remember 
as little as possible when utilized* 

All high level tools which draw graphics figures scissor 
[81 the image by permitting only the Portion of the image 
that falls in the virtual screen to be displayed. 

All routines return an indication if an error has oc- 
cured or an incorrect parameter has been passed/ thereby 
providing a debugging capability to the user. 

E. INPUT AND OUTPUT ROUTINES 

Three subroutine calls were developed to provide the 
user with an interactive inout/outout capability. The first 
is used by the user to retrieve single ASCII character codes 
from the RAMTEK keyboard. The second is used by the user to 
return an octal or decimal number from the RAMTEK keyboard. 
The third is used to return a floating ooint number to tne 
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user from the RAMTEK keyboard. These routines provide a 
powerful tool to the user in programming. 

F. MAINTAINABILITY 

The functional design and level structuring serve to 
make servicing the interface an easy task. When a specific 
function does not perform as expected, the portion of the 
interface which applies to that function is easy to find and 
isolate for testing and debuqginq. Most of the interface 
routines do error checking and s e 1 f -do c umen t a t i on when an 
error occurs. 



IX. RECOMMENDATIONS 
A. USER INTERFACE ADDITIONS 

The following modifications to the user interface are 
recommended. The design and implementation of a complement- 
ing data structure to hold and control display entities for 
transfer to and from the RAMTEK on user command would be an 
excellent and powerful' addition to the present interface. 
The data structure could utilize the existing routines with 
few changes. Such an addition would aid the user by allow- 
ing selective display and erasure of user entities with a 
single command . 

Also, further interfacing of the RAMTEK keyboard to pro- 
vide cursor control and readback of virtual or real screen 
coordinates from its location would be extremely useful. 
Several of the unused keys could be turned into function- 
type switches as well. 
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B. ADDITION OF HIGH LEVEL USER ROUTINES 



/ 



More routines to give 


the PAMTEK a dynamic qraohics 


capability is possible, 


but limited by the raster rate and 


data transfer rate. Move 


routines and selective erasure of 



entities can be accomol i shed within the confines of a well 
defined data structure. 



X. 


CONCLUSIONS 


The user interface as 


desianed and implemented is work- 



ing with no known software buos . The entire range of 
hardware capabilities of the RAMTEK have been successfully 
incorporated and tested. Several successful high level 
routines, most notably the plotting routines, oemonstrate a 



high degree of usefulness 


and are indicative of the caoabil- 


ities that a color device 


in conjuction with an aaeauate 


software interface has to 


offer. 
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APPENDIX A: USER MANUAL 



I . INTRODUCTION 

The RAMTEK GX-100A is a color, raster scan display dev- 
ice/ the heart of which is a color cathode ray tube not 
unlike a home color television set. In f act / its raster 
scan method for generating a picture is identical to commer- 
cial cathode ray tubes. At this point the similarity ends. 
Instead of decoding signals transmitted by a television 
broadcast station, the RAMTEK gets the information for its 
picture from a soecial video generator which reads the con- 
tents of a M 0 S refresh memory which contains all the infor- 
mation needed to oroauce an image on the screen. It is not 
within the scope of this manual to go into the details of 
how the electronics functions* but to inform the user on how 
to use the device to ai sol ay the desired image. 

A brief descriotion of the parts of the RAMTEK will be 
given followed by a discussion of its various display mooes. 
Next a discussion of how the user can define and utilize 
colors will be presented. 

The user is also directed to Aopendix B for information 
on how the user routines implemented in the interface are 
used and what their functions are. Periodically small se- 
quences of C code will be listed. These bits of code are 
not intended to run without the necessary C and user inter- 
face routines that must precede them. They are Presented to 
demonstrate how certain instructions are utilized. 
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II. THE RAMTEK DISPLAY SYSTEM 



A more detailed discussion of the functioning of the 
RAMTEK can be found in the RAMTEK GX-100A [9] and RAMTEK 
GX-1008 (21 programmers manuals. 

A. GENERAL 

The RAMTEK consists of a software interface to the user, 
a display generator, keyboard, video lookup table and a 
cathode ray tube. Their relationship is illustrated in fig- 
ure A- 1 . 




User Interface, RAMTEK Relationship 
Figure A - 1 

The user program executes on the PDP-11/50. When the 
appropriate instruction is executed, the interface between 
the program and the display generator for the RAMTEK is 
activated. Information can be sent via the interface to the 
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display generator from the user program or the keyboard. 
Information can also be sent from the keyboard via the in- 
terface to the user program, After the display generator 
interprets its instructions and constructs the display in 
its ROM memory* the image is generated on the CRT according 
to the colors contained in the video lookuo table. Any 
image will remain* unless over-written/ for an indefinite 
period of time in the ROM memory. 

The keyboard is interfaced to the user program and to 
the instruction display generator. Information can be 
passed from the keyboard in the form of ASCII character 
codes to the user program or to the display generator and 
finally to the CRT screen. The keyboard also contains eight 
function switches to control the action of a cursor which is 
displayed on the screen. The address of the cursor on the 
screen is always available to the user orogram via the i n- 
t e r f ac e . 

The video lookup table contains the coded information 
which is used in generating color. The table is available 
via the interface to the user program. By modifying the 
contents of the table* various colors can be displayed on 
the sc reen . 

The RAMTEK graphics display in the Naval Postgraduate 
School Computer Laboratory utilizes a raster scan cathode 
ray tube with a screen resolution of 240 horizontal lines 
and 640 elements on each line* A specific element and line 
is referred to as a pixel. This device has a high element 
resolution and a low line resolution. Therefore* the 



quality of some images on the RAMTEK can be rather poor. 
Lines that are not horizontal or vertical are drawn with a 
noncontiguous, staircase effect. When utilizing the device 
these resolution factors should be kept in mind especially 
when operating in a data mode. Addressing the CRT screen is 
discussed in the section on Virtual Screen Addressing. 

Color is generated by mixing three primary colors; blue, 
green and red in varying intensities. Using color is dis- 
cussed in a later section. 

B. VIRTUAL SCREEN ADDRESSING 

The initialization of the RAMTEK, which is accomolisned 
by the instruction r a m t e k ( ) , presets the virtual screen to a 
standard cartesian coordinate address space with (0.0, 0.0) 
as the lower left corner of the screen and (100.0,100.0) as 
the upper riqht corner. The virtual screen can be redefined 
by issuing a screen(x,y,xl,yl) instruction. 

screenO redefines the virtual screen by setting the 
lower left corner to (x,v) and the upper right corner to 
(xl,yl) • The only restrictions are that the two points 
define a valid cartesian coordinate system and the four 
values are floating point numbers. All addresses and dis- 
placements issued subsequent to a screenO instruction are 
interpreted according to the defined virtual screen. 

The virtual screen is addressed by specifing an x,y 
coordinate with a strtxv(x,y) instruction. The specified 
address (x,y) establishes the current operating point (COP) 
at that address. The COP is initially located at the lower 
left corner of the virtual screen whenever a screen is 
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defined 



The COP is occasionally modified after certain 



operations are performed as indicated in Aopendi x B and in 
the section on display modes. 

There are three modes of addressinq the screen; abso- 
lute, indexed and relative. 

1. Absolute Addressinq 

In absolute addressing the user specifies a specific 
location on the user-defined screen by issuing a 
strtxy(x,y) • The 'x* and 'v* values establish the location 
of the COP. 

2. Indexed Addressing 

To utilize indexed addressing, the user must issue 
an inqex(i,x,y) instruction. If 1 i * is equal to one, indexed 
addressing is initiated. Subsequent to tnis instruction, 
all addresses specified by the user are interpreted accord- 
ing to the values 'x f and f y' contained in the last indexC) 
instruction. For example, if a s t r t x y ( 1 0 . 0 , 1 0 . 0 ) is issued 
after an i nde x ( 1 , 1 5 . 0 , 2 0 . 0 ) has been issued, the resulting 
COP is (25.0,30.0 ) . 



To deselect indexed addressing it is necessary to 
issue an index ( ) instruction with 'i* equal to zero. The x 
and y values, if any, are ignored and the user is returned 
to the absolute addressinq mode. 

3. Relative Addressinq 

The hardware relative addressing is implemented by a 
single instruction. The issuing of a pointr(x,y) instruc- 
tion utilizes relative addressing. to hen issued, the COP is 
calculated by taking the old COP x and y values and summing 
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them with the pointrO x and y values. For example/ if the 
old COP is (22.0/50.0)/ and a pointr(30.0/-10.0) is issued/ 
the new COP becomes (52.0/40.0). Relative addressing is 
only utilized when a oointrO instruction is issued and 
always refers to the last COP. 



III. CONTROL MODFS AMO CONTROL FLAGS 

The RAMTEK operates in any one of eight modes. Each 
mode has associated with it certain control flags which 
modify its operation in the mode selected. Table A - 1 sum- 
marizes the control modes and control flags and their rela- 
t i o n s h i p . 

Control modes are set by issuing a setmoae(a/b) instruc- 
tion. The value of 'a' indicates the mode the RAMTEK is to 
be placed in. The value of ' b ' tells the interface whether 
to save the control flags of the orevious mode or not. The 
values of 'a' and 'b' that may legally be assigned are sum- 
marized in Appendix B. The control modes are as follows: 

A. ALPHANUMERIC DATA MODE 

Alohanumeric Mode is the default mode upon initializa- 
tion of the RAMTEK. All data() instructions issued while in 
this mode are interpreted as passing alphanumeric data. The 
data is processed leftmost byte first and is interpreted as 
eight bit extended ASCII character codes. Each received 
character code is transformed into a dot matrix character 
font which is five real screen elements by seven real screen 
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lines in dimension* 



The character font is within a seven 



element by twelve line matrix as illustrated in figure A-2. 
The entire character set is illustrated in reference (21. 



OLD COP 







RAMTEK Character Font 
Figure A -2 
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TABLE A - I 



CONTROL MOOES AND CONTROL FLAGS 



Definitions: 

IX - Indexed Addressing 
8K - Reverse Background 
AW - Additive Write 
DW - Double Width 
FP - Fixed Point 

YES - Indicates the Control Flag has 
effect in the Control Mode 
NO - Indicates the Control Flag does 
not have effect in the Control 
Mode 



Mode Control Flags 



No . 


Name 


IX 


BK 


AW 


DW 


FP 


0 


A ] phanume r i c 


YES 


YES 


YES 


YES 


NO 


1 


T ransverse Data 


YES 


YES 


YES 


YES 


NO 


2 


Raster Data 


YES 


YES 


YES 


YES 


NO 


3 


Comp lex Data 


YES 


YES 


NO 


YES 


NO 


a 


Grpah i c Vec tor 


YES 


YES 


NO 


NO 


YES 


5 


Graohic Plot 


YES 


YES 


NO 


YES 


YES 


6 


Graohic Cartesian 


YES 


YES 


NO 


NO 


YES 


7 


Graphic Element 


YES 


YES 


NO 


YES 


NO 
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The transmitted ASCII characters are displayed starting 
at the COP from left to right on the same line as illustrat- 
ed in figure A - 2 • If more than 91 characters are written on 
one line^ they will "wrao around" and overwrite on the same 
line. No more than twenty character lines can be displayed 
on the sc reen . 

Completion of execution of a d a t a ( ) instruction causes a 
"line feed" and "carriage return" • Each subseauent data ( ) 
instruction will display on the next alphanumeric line at 
the same starting element as illustrated in figure A - 2 . The 
new COP after each execution is also illustrated in figure 
A-2 • 

When the characters are drawn on the RAMTEK screen, the 
character appears in the designated color while the rest of 
the matrix is drawn in the background color* 

1. Applicable Control Flaps , 
a* Indexed Addressing Flag 

The effect of indexed addressing is as explained 
above in Virtual Screen Addressing* 

b. Reverse Background Flag 

If set, the character is displayed in the back- 
ground color and the rest of the matrix in the selected 
color as illustrated by the 1 Y 1 in figure A-2. 

c. Additive Write Flag 

If set, the character is written over whatever 
image happens to be at the same location on the screen. The 
use of the additive write flag is convenient for combining 
characters to create special characters or writing 
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characters close to other i nages to avoid destroying a por- 



tion of the existing image when the seven by twelve 
is written. The second aool i cat i on is illustrated in 

A-3. 

d. Oouble Width Flag 

If set, causes the displayed characters 
twice as wide as normal as i 1 1 ustrated in figure A-a 
use of double width characters decreases the maximum 
of characters oer line to ^5. 

2. Other Instructions 

See also stroutC) and IttrO on Aooendix 8 for 
tional alphanumeric generating capability. 




ma t r i x 
figure 

to be 
. The 
numbe r 

add i - 



Effect of Additive Write Flag in Alohanumeric Mode 

Figure A-3 




NORMAL 




Effect of Double width Flag in Alphanumeric Mode 

Figure A -a 

a. transverse data ^ode 

All d a t a ( ) instructions issued in transverse data mode 
are interpreted as passing transverse data. Received data 
is written in its raw format, that is, each data byte Coro- 
cessed leftmost first) is interpreted as a single bit oer 
oixel description of eight consecutive pixels along a par- 
ticular real screen line. As illustrated in figure A-5, 
consecutive data bytes are written from left to right begin- 
ning at ( the COP and continuing down. All subseauent bytes 
are written beginning at the same element on the next line. 
The COP after the operation is indicated in figure A-5. 

The typical use of transverse data is to define special 
symbols and characters which can not be found in the stan- 
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dard character set. 




Data: 





Transverse Data Processing 
Figure A - 5 

1. Aoolicable Control Flags 

a. Indexed Acdressing Flag 

The effect of indexed addressing is as exolained 
above in Virtual Screen Addressing. 

b. Reverse Background Flag 

If set/ the data is displayed as indicated in 
figure A-fe. In effect/ the comol ement of the data is 
d i sp 1 a ved . 

c. Double Width Flag 

If set/ each bit is reflected in two consecutive 
pixels instead of one/ thereby giving an image sixteen □ i x - 
els wide instead of eight. The result is illustrated in 



figure A -6 



d 



Additive flrite Flag 



If set/ the transmitted data is written over 
whatever image happens to be at tne same location on the 
screen. 




Data: 



015022 
1 33000 
000101 



000 1 1 0 1 0 
101 101 10 
00000000 



00010010 

00000000 

0100000 



OLD 

COP 



NEW 

COP 



NEW 

COP 



Effect of Reverse Background and 
Double Aidth Flags on Transverse Data 



Figure A -6 



C. RASTER DATA MODE 

Raster data mode/ except for the direction of the writ* 
ing process/ is identical to the transverse data mode. As 
illustrated in figure A-7/ the consecutive bvtes transmitted 
by the data ( ) instruction are written horizontally from left 
to right beginning at the COP. All subseouent bytes are 
written beginning at the next pixel on the same line. The 






COP after the ooerat ion is as illustrated in figure A-7. 
The control flags that apoly to transverse data mode also 
apply to raster data mode in the same manner. 



Data: 013232 

127076 



000 1 0 1 1 01 00 1 1 0 1 0 
1 0 1 0 1 1 1 000 l 1 1 1 1 0 





Raster Data Processing 



Figure A-7 



D. COMPLEX DATA MODE 

This mode is used to write data on the screen exactly 
the same, way that raster data does. However/ a third dimen- 
sion is added in this mode in that each pixel is described 
by four bits of the passed data. Therefore/ a single data 
word describes four oixels instead of two as in the previous 
data modes. 

The benefit of this mode is that tne color of each oixel 
being passed is defined by the four bits that are assigned 
to that pixel. The four bits reoresent a number from zero 
through fifteen which is used as a oointer into the color 
lookup table. If the pointer's value is six (0110), the 
color of the Pixel will be whatever is indicated in entry 
six of the color table in use. 

It can be seen that this mode overrides the color desig- 
nated by the c o 1 o r ( ) instruction. Interesting images can be 
achieved by the use of this data mode. All flags applicable 
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to paster data are apolicable to complex data except ad di- 
tive write. Piqure A - 8 illustrates how a data word is in- 
terpreted in this mode. 



DATA WORD: 




= 175163 



Complex Data Processing 
Figure A - 8 



E • GRAPHIC VECTOR MODE 

The graphic vector mode draws lines between arbitrary 
end points. The starting point is defined by the existing 
COP or can be defined by issuing a strtxy ( ) to estaolish the 
new COP, The end point can be defined by issuing either a 
DointrO instruction or a oointC) instruction. The first 
uses relative addressing and the second uses absolute or 
indexed dependinq upon the control flags* condition. 

After execution of an instruction, the COP is then the 



end point of the vector just drawn 



Therefore 



a linked 




1 i n e / 



as illustrated in figure A - 9 , can be drawn by issuing 



a strtxyO followed by successive o o i n t ( ) or pointrC) in- 
structions. 

Instructions: setmode( u >0) ; 

strtxvCIO. 0/10.0); 
ooint(5. 0/8.0); 
do i n t ( 1 2 . 0,9,0); 

DO intr(-l. 0/2.0); 




Drawing Vectors in Graphic Vector Mode 
F i gu re A -9 



1. Apolicable Control Flags 

a. Indexed Addressing Flag 

The effect of indexed addressing is as explained 
above in Virtual Screen Addressing. 

b. Reverse Background Flag 

If set/ the lines are drawn in the background 

color. 

c. Fixpoint Flag 

If set/ causes the Doint issued by a strtxyO to 
be the starting point for all subsequent end points issued. 
Therefore/ the lines are drawn with a common point as illus- 
trated in figure A — 1 0 . 
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Instructions: se t mode ( 4 / 0 ) ; 

f i xot ( n ; 
strtxy(5. 0/5.0) ; 
p o i n t ( 8 . 0/7.0); 
ooint (6. 0/5.0) ; 
pointr(-1.0/-1.0); 




(s. ,0.7. o) 



Drawing Vectors with Fi xooint Flag 



Figure A - l 0 



F* GRAPHIC PLOT MODE 

The functions performed by the graphic olot node have 
been implemented as a set of olot routines in the user in- 
terface. The three routines are olotctO/ plotlnC) ' and 
o 1 o t H ( ) . 

The first plots a function as a series of points. The 
second plots a function as a continuous line and the third 
plots a function in a histogram style plot. Each of the 
methods requires the user to specify the points to be plot- 
ted. The three plotting methods are illustrated in figure 
A - 1 1 . Detailed instructions on their use can be found in 
Appendix 8. It is recommended that these routines be used 
in lieu of the graphic plot mode as they are simpler to use 
and provide a more powerful capability. However/ for the 
programmer who is interested in using the assembly language 
level instructions necessary in this mode/ he is referred to 



reference t21 



** # * 




plotH ( ) 



Plotting Methods 
Figure A - 1 1 

G. GRAPHIC CARTESIAN MODE 

The graphic cartesian mode draws solid rectangles 
between arbitrary endpoints. The endooints a e f i ne opoosite 
corners of a rectangle. The COP is always the starting 
point of the drawing unless a new COP is defined with a 
strtxyO instruction. The second ooint can be issued with a 
ooint ( ) or oointrC) instruction. After the coeration is 
oerformed/ the new COP is the second ooint that was issued. 

By issuing successive ooints» linked rectangles can oe 
drawn as illustrated in figure A - 1 2 . In this case/ the end- 
ing ooint for one rectangle becomes the starting ooint for 
the next. 
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1. Apolicable Control Flags 

a. Indexed Addressing Flag 

The effect of indexed addressing is as explained 
above in Virtual Screen Addressing. 

b. Reverse Background Flag 

If set > the rectangles are drawn in the back- 
ground color. 

c. Fixed Point Flag 

If set/ all rectangles are drawn with a common 
starting point much in the same way it is done in the graoh- 
ic vector mode. A strtxyC) instruction determines the com- 
mon point/ and subseouent point!)' or pointrO instructions 
determine the rectangles as illustrated in figure A - l 2 . 



Instructions: setmode(6/0); 

strtxyCtO. 0/6.0); 

point (12. 0/8.0); // draws A. 

point(13. 0/9.0); // draws 8. 

f i xot ( 1 ) ; 

strtxy(5. 0/8.0) ; 

point (6. 0/6.0); / / draws C. 

do i n t ( U . 0 / 7 . 0 ) ; // draws 0. 




Drawing Rectangles with and 
Without Fixooint Flag 



F i gu re A - t 2 
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H. GRAPHIC ELEMENT MODE 



The graphic element mode draws a sinqle pixel on the 
screen as determined by a ooint () instruction or a pointrC) 
instruction. After execution, the COP is on the same real 
screen line and one screen element to the right. 

1. Applicable Control Flags 

a. Indexed Addressing Flag 

The effect of indexed addressing is as explained 
above in Virtual Screen Addressing. 

b. Reverse Background Flag 

If set, the pixels are drawn in the background 

color. 

c. Double Width Flag. 

If set, two Consecutive pixels on the same line 
are drawn instead of one. 



IV. USING COLOR 

As mentioned earlier, all images that are displayed on 
the screen are displayed according to an entry in the video 
lookup table which can also be referred to as the color 
lookup table. This section will discuss how to define 
colors the user desires, load the color lookup table/ use 
the special interactive routine to build color tables and 
use the color lookup table in user programs. 

A. DEFINING COLORS 

The RAMTEK hardware defines colors by combining red. 
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green and blue in varying intensities to produce color. 
Since the color lookup table* from which the CRT receives 
its instructions on how to mix the three colors* stores 
information in digital format* the user is limited to 4096 
possible color definitions. Since the table has a finite 
length of sixteen twelve bit entries and only one table can 
oe used at any one time* only sixteen colors can be 
displayed at any one time on the screen. It must also be 
keot in mind that entry zero in the table is used as the 
background color that is to be displayed on the screen 
thereby leaving fifteen colors for image drawing. 

In order to define an entry in the color lookup table* 
it is first important to examine how the color lookup table 
stores its information. 

1. The Color Lookup Table 

There are sixteen entries in the color lookup table. 
Each entry represents the code for a color in a twelve bit 
word. As illustrated in figure A — 1 3 * each word is broken 
into three* four bit binary numbers which represent the 
intensities of blue* green and red to be mixed. 



blue 




green 




red 


























11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 


0 



Color Lookup Table Entry Format 
Figure A - 1 3 
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It is convenient to think of the entry in each table 
as an ordered triple: (0-15/0-15*0-15). This can be extend- 
ed into a three-dimensional definition of the color soace in 
which the RAMTEK is capable of displaying color. Figure 5 
in the earlier section on Application of Color illustrates 
this concept. The x-axis contains the sixteen Possible 
shades of blue? the y-axis contains the sixteen possible 
shades of green and the z-axis contains the sixteen oossible 
shades of red. By moving within the confines of the cube* 
all 4096 colors are defined* and their relationship to each 
other is illustrated. 

2 . Defining Color Table Entries 

In order to define an entry in the color lookup 
table* it is necessary to transform from an ordered triple 
to the twelve bit coded form. This is accomplished by a 
special routine called t r i p 1 e ( b * g * r ) . The ordered triple 
(b*g*r) directly corresponds to the color cube location 
reoresenting the color the user desires. The routine re- 
turns the properly coded entry for loading into a color 
table. 

B. LOADING THE COLOR LOOKUP TABLE 

The RAMTEK interface system oermits the use of eighteen 
separate color tables. The first four tables (0-3) are 
reserved system tables and cannot be modified in any way. 
Some of the other tables already have entries in them for 
the benefit of the user who wishes to use them* and others 
are emo t y . 

There are three methods of loading a color lookup table 
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in the user's program. One/ the interactive color routine 
will be discussed separately. The other two are discussed 
here. The first is a method for loadina an entire color 
lookup table/ and the second is for loadinq a single entry 
in a color lookup table. 

1. Loading an Entire Table 

To load a whole color lookup table requires a series 
of operations. First/ the user needs to declare a sixteen 
word/ linear integer array. Then it is necessary to load 
each entry of the array from zero to fifteen with the six- 
teen colors that are desired. In order to accomplish this/ 
it is recommended that the triple!) routine be used to code 
the ordered triples and then assign the returned codes to 
each entry in the array. 

After the array has been loaded/ it is then entered 
into the desired color lookup table by the routine 
C 1 rt b 1 ( n / name ) . The parameter 'n' is the number of the 
color lookup table (4-17) and 'name' is the name of the user 
array which contains the sixteen coded entries to be loaded. 

An example of the code to load a color table is as 

f o 1 lows: 



int a(16); //declares sixteen word array, 
a 1 0 ] = t r i o I e ( 0 / 0 / 0 ) ; // color black, 

all) = t r i p I e ( 1 5 / 0 / 0 ) ; // color blue, 

a 121 = t r i p 1 e ( 0 , 1 5 / 0 ) ; // color green. 



a ( 1 5 ] = triple(l5/15/15)? / / color white. 

clrtbl(5/a); //loads color lookup table. 



The color lookup table entries contained in the array * a ' 
are loaded into color lookup table number five and are then 
ready for use, 

2 • Single Entry Loading 

It may/ at times/ be desirable to load only one 

entry in a given color lookup table. In order to do so/ the 

entry is coded with the triple routine and then loaded in a 

specific table and entry by using the chnge(numb/entry/Cont) 

routine. For example/ to load the color defined by the 

ordered triple (5/6/10) into entry three of color lookup 

table ten/ the following two instructions are issued: 

cont - triole(5/6/10); 
c h nge ( 1 0 / 3 / con t ) ? 

If the change takes place in a color lookup table that is 
being used for display/ the change is reflected on the 

screen immediately. 

C. INTERACTIVE COLOR PROGRAM 

The purpose of the interactive program is to allow the 
user to see and modify color lookup tables while seated at 
the RAMTEK keyboard. It is recommended that the new user 

sit down at the RAMTEK and execute interC) in order to get 

an introduction to the color generating capab i 1 i t i eso f the 
RAMTEK. There are two basic modes in which the routine 
operates. Each of these modes has a series of commands 
which the user can execute. Appendix 3 describes the com- 
mands for each mode in detail in its description of interC). 
1 . Paging Mode 

The paging mode permits the user to page through the 
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eighteen possible color lookup tables. Upon execution of 
interO the paging mode is automatically entered and a set 
of tutorial instructions are displayed. 

2 . Edit Mode 

The routine provides five separate methods of edit- 
ing and modifying color lookup tables and their entries. 
How to use the methods is described in Appendix B in the 
description of interO . 

a. Table Assignment 

Table assignment mode allows the user to 
copy entries from any table into a designated user table. 

b. Octal Assignment 

Entries in a designated user table can be 
defined by enteri nq an ordered octal triple representing the 
color desired. 

c. Combining Assignment 

Entries from two color lookup tables can be 
logically OR'd into a desianated user table or two whole 
tables can be 0 R * d into the user table. 

d. Inverting Tables 

This method permits the user to invert a 
designated table. Entry zero becomes entry fifteen, entry 
one becomes entry fourteen and so on. 

e. Copying Tables 

This method permits the user to make copies 
of any table in the system into a selected user table. 
Thus/ the user can modify a system table without destroying 
i t . 
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D. PROGRAMMING WITH COLOR 



Using color on the RAMTEK is not a difficult process 
once the user understands color lookup tables and their 
entries. As mentionec earlier/ the system has capability at 
present of storing uo to eighteen color lookuD tables. 
Tables zero through three are reserved system tables leaving 
tables four through seventeen for the user. The system has 
some preloaded tables which contain a variety of colors that 
the user may find useful. If not, they can be destroyed as 
des i red . 



It is a good practice for the user to design his pro- 
grams making use of the interO routine. By placing the 
inter!) routine inside a looo, the user can modify the table 
or tables the orogram uses/ run tne program and return/ if 
desired/ to the inter!) routine to chanae entries in the 
color lookup tables until the desired colors are achieved. 
The user should then save the codes for future use. 

Issuing a colort(n) instruction in the user program 
causes the designated color lookuo taole to be loaded into 
the RAMTEK hardware video lookup table. All images are then 
displayed relative to the colors contained in table 'n'. In 
order to select a specific color to be used/ the color(e) 
instruction is issued. All images drawn subsequent to this 
instruction will be drawn with the color contained in entry 
*e' of the color lookup table last selected. 

For examole/ suppose color table five was the table the 

user wished to use/ and it contained the following entries: 

entry zero - black (0/0/0) 
entry one - red (0,0/15) 
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entry two - blue (15,0,0) 
entry three - green (0,15,0) 



The following instructions would disolay a red rectangle, a 
blue line and a green letter 'A' on a black background. 
Entry zero always contains the background color. 



co 1 o r t ( 5 ) ; 
co 1 or ( 1 ) ; 

//draw red rectangle. 

setmode(6, 0) ; 



//loads color table five, 
//selects entry one (red). 



//set Graphic Cartesian 
mode . 

strtxy(5. 0,5.0) ; 
do i n t ( 1 0 . 0 , 10 . 0 ); 

//draw blue line. 

color(2); //select entry two (blue), 

se t mode ( 4 , 0 ) ; //set Graphic Vector mode. 

strtxy(l5. 0,15.0); 
point (22.8, 10.5) ; 

//draw green letter 'A'. 

c o 1 o r ( 3 ) I //select entry three (green), 

se t mode ( 0 , 0 ) ; //set Alphanumeric mode. 

S t rt xy (50 . 0,25.0); 

data(letter,l); //letter is an array containing 

//the ASCII code for an 'A'. 



If at any time a new color table is entered, all exist- 
ing images will change color to the entries that are in the 
new table. .Also, if at any time an entry in the table being 
used is changed, any image on the screen that was drawn with 
that entry number will change to the new color. If in the 
preceding example the next instruction loaded a table which 
contained the color white in entries one and two, and blue 
in three, the rectangle and line would become white and the 
letter 'A' would become blue. 
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V. PROGRAMMING THE RAMTEK 



There are two routines which it is necessary to Diace at 
the beginning of any C program which desires to utilize the 
user interface for the RAMTEK. 

The r a m t e k ( ) routine must be the first call made in the 
user program. It is the initialization routine for the user 
interface and it opens the RAMTEK device and keyboard. 

The eraseO routine should follow the ramtekC) routine. 
This ensures that any old images on the screen or in the 
RAMTEK memory will be removed. 

Appendix 8 contains a complete list of the user routines 
which will relieve the user of a significant amount of pro- 
gramming effort in many cases. Most user routines return 
negative values for error conditions or if incorrect parame- 
ters are passed. It is therefore advisable to be aware of 
the values and their meanings to aid in debugging programs. 

In order to utilize the interface, the following compile 
command should be issued: 



cc filename - 1 r 



A. RESERVED WORDS 

Table A — I I contains a list of reserve words. These 
words should not be used for user names in any programs that 
utilize the user interface for the RAMTEK device. Some of 
the words are user interface routine names and others are 
variables and subroutine names in the interface software. 
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TABLE A - 1 I 



RESERVED WORDS 



ADOFF 


FPOFF 


po i n t r 


adon 


f oon 


p r oc 1 


ALPHA 


ge t f 


proc2 


axis 


get num 


p r oc 3 


BKON 


graphcrt 


p roc 4 


BKOFF 


graphelm 


proc5 


bk rnd 


GRAPHVEC 


p t rbu f f 


blank 


head 


pu t UD 


BLK 


headot r 


qpt r 


block 


heat 


qp t r 1 


bracket 


ho 1 dx 


at 


buff 


ho 1 dy 


auest 


by t ecnt 


index 


q 1 


c 


i not rs 


r am t e k 


c hnae 


i n s t r 


RASTERD 


cl rho 1 d 


inst 1 «* i n s t 8 0 


re t c h a r 


cl r t b 1 


inter 


s c i ssor 


code 


i nt 53 


SCR 


code i t 


i n t 6 0 


screen 


coke 


i t oa 


scrol 1 


color 


IXOFF 


SDC 0 


c o 1 o r t 


IXON 


se t mode 


c o 1 o r t b 1 


LCM 


setup 


comb 


1 cmho 1 d 


size 


COMMA 


LER 


skip 


COMPD 


LEX 


SSC ALL 


conve 


LEI 


s t rout 


c on v 1 


LE2 


s t r t x y 


c ooy 


LLR 


sy s t b 1 


CR 


LLX 


t b 1 who 


data 


LL1 


TRANSD 


dat ao 


LL2 


triple 


db 1 w i d 


LTA 


uocnt 


d i sd 


LTD 


vector 


dumo 


1 1 1 r 


wait 


e i ns t 


LXD 


WDOFF 


eoaqe 1 


mo r e i n s t 


WDON 


epage2 


n 0 -n 1 7 


w r i ton 


epaae 3 


oc t b 1 


x a x i s 


erase 


out 


x m i n 


ERS 


pause 


xmax 


f i X D t 


o i c k 


y a x i s 


f 1 i o 


p 1 o t p t 


yax i s f 


f name 


o 1 ot 1 n 


y m i n 


f D 


p 1 ot h 
point 


y ma x 
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APPENDIX 8: USER INTERFACE ROUTINE DESCRIPTIONS 

This Appendix contains the descriptions of the 
interface routines in the format that is followed in 
documentation of the UNIX operating system in the 
Postgraduate School Computer Laboratory. 



user 

the 

Naval 



axis 



Jun 10 1976 



axis 



NAME: 



axis - draw coordinate axis 



SYNOPSIS: 

a x i s ( x t y ) 
float x , y ; 



DESCRIPTION: 

Draws a cartesian coordinate x and y axis on the 
screen with center at user-defined screen coordinate 
( x , y ) . 

The operation is totally indeoendent of any control 
mode issued previously. 

The COP is left at (max x-value>y). Normal return is 
zero. 



DIAGNOSTICS: 

Returned -1 indicates no oortion of the axis lies on 
the user-defined screen. 
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b k rnd 
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b k rnd 



NAME: 

bkrnd - chanae reverse background flag 



SYNOPSIS: 

bk r nd ( a ) 
int d/ 



DESCRIPTION: 

If a is zero , the reverse background flag in the con- 
trol mode is set to zero* i.e. turned off. 

If a is equal to oner the reverse background flag in 
the control mode is set to one/ i.e. turned on. 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the oassed integer q is not 
equal to zero or one. 
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block 
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block 



NAME: 

block - draw solid block 



SYNOPSIS: 

b 1 oc k ( x 1 / y 1 , x2 / y 2 ) 
float xl,yl,x2,y2; 



DESCRIPTION: 

A solid block is drawn with opposite corners as de- 
fined by user-defined screen coordinates (xl,yl) and 
( x 2 , y 2 ) . 

The COP is left at (*2/y2). The operation is indepen- 
dent of any mode issued previously but is sensitive to 
all flags applicable to Graphic Cartesian mode. 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the block can not be drawn on 
the user-defined screen. 



SEE ALSO: 

index()/ bkrndO/ dblwid!) 
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c h nqe 



NAME: 

c hnge - change color table entry 



SYNOPSIS: 

Chnge(numt), entry, cont ) 
int numb, entry, cont; 



DESCRIPTION: 

Changes the specified entry in the indicated color 
table to the passed oarameter cont. triple!) should 
be used to put cont into the prooer form. 

numb is the table number in which the entry is to be 
changed. entry is the entry number to be changed, 
cont is the integer twelve bit code which is 1 oaaed in 
the specified entry. 

Normal return is zero. 



DIAGNOSTICS: 

All errors are indicated by negative returned values. 
The error values and their meanings are as follows: 



Indi cates 
seventeen 


numb i 

• 


s less than 


four or greater 


than 


Indi cates 
teen. 


ent ry 


i s negat i ve 


or great er than 


f i f- 



SEE ALSO: 

triple!) 
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cl r t D 1 
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cl r t b 1 



NAME: 

clrtbl - load color table 



SYNOPSIS: 

cl rtbl (n,name) 
int n / *name T 



DESCRIPTION: 

Loads color table number n with the codes contained in 
the array pointed to by name/ 

The array is an integer array containing sixteen in- 
tegers which represent the octal code of the color 
table entries between zero and sixteen. The array is 
assumed to be declared sixteen words in length. 



n is an integer value which ranges from four to seven- 
t een . 



The color tables from 
tables. They contain 
Table 0 - Fifteen 
Table 1 - Fifteen 
Table 2 - Fifteen 
Table 3 - Fifteen 



zero to four are system 
the follow i n a : 
shades of grey . 
shades of blue, 
shades of green . 
shades of red. 



d e f i n e d 



If the user desires to modify a system table see 
inter!). 



/ Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the passed integer n is less 
than four or greater than seventeen. 



SEE ALSO: 

triple!) 
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color 



NAME : 

color - select color 



SYNOPSIS : 

co 1 o r ( s ) 
i n t s ; 



DESCRIPTION: 

The passed integer s is the number of the 
current color table. The color located 
will be used for all subseauent entiti 
until a different color is issued. 

s is between zero and fifteen. 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the oassed integer 
or greater than fifteen. 



SEE ALSO: 

chnge ( ) 



entry in the 
in that entry 
es d i sd 1 ayed 



s i s nega t i ve 
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c o 1 o r t 



Jun 10 1976 



cotort 



NAME. : 

colort - select display color table 

SYNOPSIS: 

col ort (t ) 
i n t t ; 



DESCRIPTION: 

The passed oarameter t is the number of the color 
table that is sent to the ramtek device for display. 

t is between zero and seventeen. 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the oassed integer t is negative 
or greater than seventeen. 



SEE ALSO: 

c 1 r t b 1 ( ) 
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NAME : 

data - display raw data 



SYNOPSIS: 

data (name » 1 ) 
i nt *name > 1 '• 



DESCRIPTION: 

The raw data passed in the linear array Pointed to by 
name is displayed on the ramtek according to the 
current control mode. 

1 is the length of the array in bytesl 
Normal return is zero . 



DIAGNOSTICS: 

Returned -1 indicates the passed integer 1 is negative 
or zero. 

SEE ALSO: 

st rout ( ) » 1 t t r C ) 
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db 1 w i d 



Jur. 10 1976 



db 1 w i d 



NAME: 

dblwio - change double width flag 



SYNOPSIS: 

db 1 w i d ( x ) 
i n t x ; 



DESCRIPTION: 



If x is 


eaual 


t 0 


zero r 


the doub 1 e 


width 


f 1 ag 


c on t ro 1 


mode 


i s 


set to 


zero , i . e . 


turned 


off. 


If x is 


eaua 1 


t o 


one • 


the douo 1 e 


width 


f 1 ag 


control 


mode 


i s 


set to 


one / i . e . 


turned 


on . 



Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the oassed integer x i 
eaual to zero or one. 



SEE ALSO: 

s i ze ( ) 



n the 
n the 

s not 
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erase 



NAME: 

erase - erases the screen 



SYNOPSIS: 

erase!) 



DESCRIPTION: 

The ramtek screen is erased to the background color of 
the color table currently being used. 



71 



f i xpt 



Jun 10 1976 



f i xpt 



NAME: 

f i x p t - change fixed point flag in control mode 



SYNOPSIS : 

f i xpt ( x ) 
i n t x ; 



DESCRIPTION: 

If x is eaual to zero* the fixed point flag in the 
control mode is set to zero* i.e. turned off. 

If x is eaual to one* the fixed ooi nt flag in the con- 
trol mode is set to one* i.e. turned on. 

Meaningful only in Graphic Vector or Graphic Plot 
mode. In Graohic Vector mode it causes all subsequent 
vectors to be drawn with one end at the same point as 
issued by a subsequent or last previous strtxyO. See 
the user's manual for fixptO's meaning in Graohic 
Plot. 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the passed integer x is not 
equal to zero or one. 
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get f 
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ge t f 



NAME 



getf - read floating ooint number from ramtek keyboard 



SYNOPSIS: 

ge t f ( ) 



DESCRIPTION: 
Returns 
board, 
minus s i 
c o n t a i n i 
by the 1 



a floating Doint number from the ramtek key- 
The only numbers recognized are: an optional 
gn followed by a string of digits optionally 
ng one decimal point/ then followed optionally 
etter 'e' followed by a signed integer. 



Normal 



return is the 



floating do 



n t numbe r . 



SEE ALSO: 

aetnumC)/ retcharO 
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ge t num 
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ge t num 



NAME : 

getnum - read number from ramtek keyboard 



SYNOPSIS: 

getnum(base) 
i nt base ? 



DESCRIPTION: 

Returns a positive or negative integer number from the 
ramtek keyboard. Numerals tyoed up to a comma or a c/r 
on the keyboard are consioered to be the number. The 
routine will not return any value until a c/r or a 
comma is typed/ nor will it accept characters other 
than digits from zero to nine when base is equal to 
ten, or digits from zero to seven in case of base 
eight . 

base is the base of the integer number returned. It 
is restricted to eight (octal) or ten (decimal). 

Normal return is the integer numbe r . 



DIAGNOSTICS: 

All errors are indicated by negative returned values. 
The error values and their meanings are as follows: 

-1 Indicates a c/r was struck without any previous 
entries. 

-2 Indicates the passed parameter base was not eaual 
to eight or ten. 

SEE ALSO: 

re t c h a r ( ) / 



ge t f ( ) 



index 
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index 



NAME: 

index - select indexing 



SYNOPSIS: 

i nde x ( i ,x,y) 
float x / y ; 
int i ; 



DESCRIPTION: 

If i equals zero* indexing is deselected and the in- 
dexing flag in the control mode is turned off. The 
index registers are then loaded with zero. 

/ 

If i eauals one* index i n a is selected and the indexing 
flag in the control mode is turned on. The index 
registers are then loaded with the displacements 
passed in x and y. x is loaded in the x-index regis- 
ter and y is loaded in the y-index register. 

x must be no greater than the user-defined screen 
width. y must be no greater than the user-defined 
screen height. 

Normal return is zero. 



DIAGNOSTICS: 

All errors are indicated by negative returned values. 
The error values and their meanings are as follows: 

-1 Indicates the passed integer i is not eaual to 
zero or one. 

-2 Indicates one of the passed displacements x and y 
is greater than the screen height or width. 



SEE ALSO: 

sc reen C ) 
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inter 



NAME : 

inter - interactive color table modification routine 



SYNOPSIS : 

i n t e r ( ) 



DESCRIPTION: 

Sets up and runs a tutorial program that enables the 
user to look at » select and modify color tables during 
program execution. There are two basic modes in which 
the routine operates. Each of these modes has a 
series of commands which the user can execute. 

1. Paginq Mode. Upon execution the paging mode is 
immediately entered and a set of instructions is 
displayed. The following commands are then accept- 
able: 



'p' 


- Indicates a oarti 
displayed. The 

between zero and 


cul ar table number i 
number must then be 
seven t een . 


s t o be 
entered 


•n ' 


- Increments 


table 


numbe r displayed 


by 


one . 


•b ' 


- Decrements 


table 


numbe r displayed 


by 


one . 


' i ' 


- Displays i 


ns t rue t 


ions. 






'q' 


- Quits from 


the interactive routine 


+ 




•e' 


- Enters the 


edit mode . 







2. Edit Mode. When the edit mode is entered/ a set 
of instructions is displayed listing the commands that 
can be issued and the edit method they initiate. The 
commands are: 

* t ' - Enters table assignment method. Permits 
entries from any table to be copied into the 
table designated by the user. The table 
number which is to receive the copied en- 
tries must be entered first. 

'o' - Enters octal assignment method. Entries are 
specified in a designated table by entering 
the ordered triple that defines the color 
desired. The table number (4-17) in which 
the entries are to be defined must be en- 
t e red first. 

' c ' - Enters combining assignment method. This 
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inter 



method allows the user to logically OR two 
separate color lookup table entries into a 
selected user table entry. Whole tables may 
also be combined into a selected user table. 
The user table number (4-17) must be entered 
f i r s t . 

' f ' - Enters inverting tables method. This method 
inverts the user table designated by the 
user. Entry zero becomes fifteen/ entry one 
becomes fourteen/ etc. The act of entering 
the user table number executes the inver- 
sion. 

' m ' - Enters copying tables method. After entry 

of the user table number that is to receive 
a copied table the number of the table to be 
copied is entered. The act of entering the 
second table number causes the copy to take 
place. 

Upon entry/ the editing methods display a list of 
instructions on how the method is to be used and the 
results obtained. Each of the methods have commands 
that may be issued. . The legal commands for each edit 
method are summarized below. 

- Table Assignment Method. 

'n' - Indicates the table number and entry 

to be copied follows. 

'c/r'-Increments through the entries 
in the receiving user table. 

'o' - Disolays the color 1 ookuo table be- 

modified. To return from the dis- 
play/ type a 'g'. 

'g' - Quits back to edit mode instructions. 

- Octal Assignment Method. 

' n ' - Indicates the octal triple to be en- 
tered as the entry follows. 
'c/r'-Increments through the entries 
in the receiving user table. 

'o' - Displays the color lookup table be- 

ing modified. To return from the 
disDlay/ type a 'o'. 

'g' - Quits back to edit mode instructions. 
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- Combining Assignment Method. 

'n' - Indicates the two ordered pairs 

designating the table number and 
entry number to be OP'a are to fol- 
low. 

1 c / r ' - I nc r emen t s through the entries in 
the receiving user table. 

'o' - Displays the color lookup table 

being modified. To return from 
the display/ type a 'o'. 

' w ' - Indicates two whole tables are to 
be combined (OR'd) and their num- 
bers are to follow. 

'q' - Quits back to edit mode instructions. 



'P' 



table that 



- Inverting Tables Method. 

Displays the color lookup 
ng or was inverted, 
back to edit mode instructions 





i S 


be 


'q' 


- Q u 


i t s 


Copying 


Tab! 


es 


•p' 


- Di 


sp 1 


'q' 


- Qu 


i t s 



Method. 

avs the receiving table, 
back to edit mode instructions 
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NAME : 

lttr - display single character 



SYNOPSIS: 

lttr(chzsize) 
int c h / size; 



DESCRIPTION: 

Will display the character passed with the size indi- 
cated at the current operating point. 

After display/ the current operating point is on the 
same line and seven actual screen elements to the 
right of its last position. 

ch contains the ascii code for the character to be 
displayed. 

If size is eaual to one/ the character is displayed in 
standard size. 

If size is equal to two/ the character is displayed in 
doub le width size. 

The operation is independent of any mode issued previ- 
ously/ but is sensitive to the flags applicable to 
Alphanumeric mode. 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the passed integer size was not 
equal to one or two. 



SEE ALSO: 

strout () / data!)/ sized/ index!)/ 



bkrndO/ w r i t on ( ) 
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NAME : 

cloth - clot data as a histogram 



SYNOPSIS: 

oloth(x,y,n,base) 
float * x , * y / base? 
i n t n ? 



DESCRIPTION: 

The values ytil are assumed to be functions of x(i]. 
As the function is clotted/ the area between the curve 
and the x-axis/ as designated by base/ is filled in 
with the color last selected. 

That oortion of the histogram that lies on the screen 
will be clotted. 

The ooeration is totally indecendent of any control 
mode issued oreviously. 

x and y are oointers to linear arrays, 
n is the number of ooints to be clotted. 

Normal return is zero. 



DIAGNOSTICS: 

All errors are indicated by negative returned values. 
The error values and their meanings are as follows: 

Returned -1 indicates the gassed oarameter base is not 
on the user-defined screen. 



SEE ALSO: 

plotlnC)/ olotctO 



80 



P 1 0 t 1 n 



Jun 10 1976 



P 1 o t 1 n 



NAME : 

Plotln - plot data with connected lines 



SYNOPSIS: 

plotln(x,y,n) 
float * x / *y ? 
i n t n ; 



DESCRIPTION: 

. The values yCil are assumed to be functions of x t i ] . 
As the function is plotted/ the successive points are 



connected by 
ed . 


straight lines 


of the color 


last 


select- 


That portion 


of the plotted 


curve which 


lies 


on the 


screen will 


be plotted. 








The ooerat i on is totally independent of 


any 


control 



mode issued oreviously. 

x and y are pointers to linear arrays, 
n is the number of points to be plotted. 



SEE ALSO: 

p 1 o t h ( ) » plotPtH 
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NAME: 

plotpt - plot data with points 



SYNOPSIS : 

plotpt (x t y > n) 
float * x f *y ; 
i n t n ; 



DESCRIPTION: 

The values of ytil are assumed to be functions of 
xti]. The function is plotted with dots for each 
(x(i]*y[ij) coordinate. The dots are the color last 
selected. 

If a point does not lie on the user-defined screen? it 
is not plotted. 

The operation is totally independent of any control 
mode issued previously. 

x and y are pointers to linear arrays, 
n is the number of points to be plotted. 



SEE ALSO: 

oloth(), plotlnO 
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NAME: 

point - define point 



SYNOPSIS: 

po i nt ( x , y ) 

float x , y ; 



DESCRIPTION: 

Defines a point on the user-defined screen. The point 
must lie within the user-defined screen. 

If in Graphic Vector m o d e » ( x , y ) defines the endpoint 

of a vector and causes it to be drawn. The current 
operating point is then (x,y). 

If in the Graphic Element mode> (x» y) defines a single 
point on the user-defined screen and causes a dot to 
be drawn there. The current ooerating point is then 
( x , y ) . 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the oassed point does not lie on 
the user-defined screen. 



SEE ALSO: 

s t r t x y ( ) 
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NAME: 

poi nt r - define a point relative 



SYNOPSIS: 

do i n t r ( x / y ) 
float x f y ? 



DESCRIPTION: 

Defines a ooint on the user-defined screen relative to 
the last current operating point. 

If in Graphic Vector mode a vector from the last 
current operating ooint to a ooint defined by the last 
current operating ooint plus the displacements x and y 
is drawn. 

If in Graphic Element mode a dot is drawn at a point 
defined by the last current operating ooint plus the 
displacements x and y. 

The COP is left at the calculated location. 



SEE ALSO: 

s t r t x y ( ) 
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NAME: 

ramtek - initiates ramtek system 



SYNOPSIS: 

ramtek ( ) 



DESCRIPTION: 

Initiates the ramtek system ana sets the default con- 
ditions as follows: 

1 - Initialize the user-defined screen to 0.0 to 

100.0 in x and y. 

2 - Loads a shades of grey color table (0) in the 

ramtek. 

3 - Selects color fifteen in table zero for display. 

4 - Selects AlDhanumeric control mode. 

5 - Opens the ramtek for readina and writing. 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 i n a i cates ramtek device could not be 
opened . 
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NAME: 

retchar - read a character from ramtek keyboard 



SYNOPSIS: 

r e t c h a r ( ) 



DESCRIPTION: 

An ascii code representing the typed character is 
returned in the lower half of an integer. 



SEE ALSO: 

getnumO, ge t f ( ) 
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NAME: 

screen - define user screen 



SYNOPSIS: 

screen(xl,yl,x2,y2) 
float x 1 » y 1 , x 2 > y 2 / 



DESCRIPTION: 

Defines a standard cartesian coordinate system of any 
scale for the user. The point (xl,yl) becomes the 
coordinate of the lower left corner of the screen. 
The point (x2*y2) becomes the coordinate of the upper 
right corner of the screen. 

xl must be strictly less than x2. 

yl must be strictly less than y2. 

All subsequent user coordinates are interpreted a c - 
cording to this user-defined screen. 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates xl is not less than x2 or yl is 
not less than y2. An error message is also printed on 
the terminal screen. 
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NAME : 

scroll - scroll screen 



SYNOPSIS : 

scrol 1 (a»cnt) 
char a; 
float cnt J 



DESCRIPTION: 

The current displayed picture on the screen is 
scrolled up or down. Information scrolled off the top 
of the screen will be scrolled in the bottom and 
v i ce*versa . 

If a is the character ' d ' / the direction of the scroll 
will be down . 

If a is the character ' u ' > the direction of the scroll 
will be up . 

cnt is the number of user-defined y-units that the 
picture is to be scrolled. cnt can be no larger than 
the sc reen height. 

Normal return is zero. 



DIAGNOSTICS: 

All errors are indicated by negative returned values. 
The error values and their meanings are as follows: 

-1 Indicates the passed parameter cnt was less than 
zero or greater than the screen height. 

-2 Indicates the passed parameter c was not a ’ d ' or 
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NAME : 

setmode - select control mode 



SYNOPSIS: 

setmode(azb) 
int a / b » 



DESCRIPTION: 

Selects the control mode according to the passed 
parameters a and b. a represents the control mode as 
f o 1 lows: 

0 - Alphanumeric 

1 - Transverse Data 

2 - Raster Data 

3 ' - Como lex Data 

4 - Graphic Vector 

5 - Graphic Plot 

6 - Graphic Cartesian 

7 - Graphic Element 

All flags are turned off if b is eaual to zero. If b 
is equal to one# any flags set in the previous mode 
are also set with the mode selected by a. All enti- 
ties displayed suoseauent to this call are displayed 
according to the selected mode. Routines that disre- 
gard the selected -node are axis!)/ block!)/ inter!) » 
lttr!)/ olothO; plotlnC), plotptC) and vector!). 

Normal return is zero. 



DIAGNOSTICS: 

All errors are indicated by negative returned values. 
The error values and their meanings are as follows: 

-l Indicates the passed parameter a was less than 
zero or greater than seven. 

-2 Indicates the passed parameter b was not equal to 
zero or one . 

SEE ALSO: 

ram t e k ! ) / bkrnd! ) ^ db 1 w i d ( ) / fixptO/ index!)/ 
w r i ton!) 
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NAME: 

size - select letter size 



SYNOPSIS: 

s i ze ( r ) 
i n t r ; 



DESCRIPTION: 

If r is equal to one the standard character si 
used. 

If r is eaual to two the double width character 
is used . 

Sets the double width flag in the control 
Therefore size takes the same action as dblwidO 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the passed parameter r i 
equal to one or two. 



SEE ALSO: 

db 1 w i d ( ) / stroutOf lttr() 



s i ze 



ze i s 
size 
mode . 



s not 
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NAME: 

strout - output character string 



SYNOPSIS: 

strout ( sd ) 
char * sp ? 



DESCRIPTION: 

Outputs a character string no greater than 100 charac- 
ters Iona beginning at the current operating point and 
continuing on the same line. After completion, an 
automatic line feed occurs which defines a new current 
operating point on the next line at the same starting 
point as the previous line. 

sp points to the character string to be output. 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the string contained more than 
100 characters. In this case no characters will be 
di spl ayed. 



SEE ALSO: 

dataO/ s i z e ( ) / IttrO 
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NAME: 

strtxy - establish current operating point 
SYNOPSIS: 

Strtxy(x»y) 
float x , y ; 



DESCRIPTION: 

Establishes the current operating point on the screen 
for subseauent instructions. If the current mode is 
Graphic Vector with the fixed point flag set » it es- 
tablishes the base from which the vectors are drawn. 

x is auser-defined screen location in x. y is a 
user-defined screen location in y. 

(x,y) must lie within the user-defined screen. 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates (x,y) does not lie on the user- 
defined screen. 



SEE ALSO: 

fixptO, screen!), point!) 
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NAME: 

tblwho - request for current color table number 



SYNOPSIS: 

t b 1 who ( ) 



DESCRIPTION: 

Returns an integer value which is the table number of 
the color table that is currently being used for 
display. 
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NAME : 

triple - cope color from three number triple 



SYNOPSIS: 

triple(b>g/r) 
i n t b , g , r ; 

DESCRIPTION: 

The three input parameters representing the amounts of 
b1ue(b)> green (g) and red(r) are coded into an integer 
which is suitable for insertion into color table en- 
tries. 

b is between 0 and 15 and represents the amount of 
blue desired. 

g is between 0 and 15 and reoresents the amount of 
green desired. 

r is between 0 and 15 and reoresents the amount of red 
des i red . 

Normal return is an integer representing the code. 



DIAGNOSTICS: 

Returned -1 indicates incut Parameters b > g or r are 
negative or greater than 15. 



SEE ALSO: 

c h nge ( ) , c 1 r t b 1 ( ) 
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NAME : 

vector - draw single vector 



SYNOPSIS: 

vector(xl,yl/x2>y2) 
float xlr yl / x2/ y 2 ? 



DESCRIPTION: 

A vector is drawn on the screen from user-defined 
screen coordinate Cxl/yl) to (x2»y2). The current 
operating ooint is left at (x2/y2). 

The operation is independent of any mode issued previ- 
ously but is sensitive to the flags applicable to the 
Graphic Vector control mode. Undesired results may be 
obtained if the fixot flaq is set previous to calling 
vector!) . 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates no portion of the indicated line 
lies on the user defined screen. 



SEE ALSO: 

bkrnd()» dblwid, fixotC)/ index!) 
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NAME: 

wri ton - additive write 

SYNOPSIS: 

wri ton(w) 
i n t w ; 



DESCRIPTION: 

If wise one/ the additive write flag in the control 
mode is turned on causing 'subseauent entities in 
Alphanumeric, Raster Data and Transverse Data modes to 
write on too of previous entities without destroying 
them* 

If w is a zero, the additive write flag in the control 
mode is turned off. 

Normal return is zero. 



DIAGNOSTICS: 

Returned -1 indicates the passed integer w is negative 
or greater than one. 
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